home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_2 / magiceye / magiceye.doc < prev    next >
Text File  |  1982-07-29  |  10KB  |  192 lines
  1.         __       __
  2.         )\\     /((  Version 37.4                            __
  3.        /  \\   /  \\         39.4  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.       sMail:                                               ________ ___ _____
  13.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  14.   Hagenmähderstr.9    krabbe@informatik.fh-augsburg.de   / _//   \  /// _//
  15. D-86391 Stadtbergen                                     / //__   / /// //__
  16.   (GERMANY)                        WWW:                 \___//  /_// \___//
  17.                 http://www.fh-augsburg.de/~krabbe/magiceye/
  18.  
  19.                             An AugustA team Release!
  20. --------------------------------------------------------------------------------
  21.  
  22. Copyright:
  23.   This program and all accompanying files (program-icon) are copyrighted 1996 by
  24. Christian 'cr8y' Krapp! You can  copy these files to your friends as long as the
  25. files are unchanged. It is not allowed to demand a fee higher as media costs and
  26. a (little)  copy-fee. In addition,  no one is allowed to put these  files onto a
  27. PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  28.  
  29. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  30.  
  31.   This  program isn't  Public Domain or Shareware. It's is developt as Freeware.
  32. Everyone, who use this program, should  send me an postcard or an eMail. (I want
  33. to know, how many (or much? ;^) ) Amiga-Fans use this program).
  34.  
  35.   When you use this little program, than you use it on your own risk! The author
  36. take no respons for damage made by MagicEYE!
  37.  
  38. --------------------------------------------------------------------------------
  39.  
  40. What is it?
  41.   No: This  is not  again  a program  to render  3D pictures!  Do you  know  the
  42. MagicWB-  or NewIcons-Stuff? (what  a question ;^> ) And: I think you know these
  43. funny Eye-programs,  which fellow the mouse-pointer! Ok. Than you know MagicEYE.
  44. It's an Eye-program for an upstyled Workbench.
  45.  
  46. --------------------------------------------------------------------------------
  47.  
  48. 10 reasons, why to use this program:
  49.  
  50.  1.) colorized eyes ;^)
  51.  2.) automatic window close, when WB is closed (screennotify.library)
  52.  3.) you can configurate a lot
  53.  4.) patch to have an screen-drag MagicEYE-window
  54.  5.) 6(!) different eye-effects
  55.  6.) colorremapping, MagicWB nolonger needed (AmigaOS 3.0+)
  56.  7.) very short program
  57.  8.) it's an commodity
  58.  9.) can copy screen-background into MagicEYE-window
  59. 10.) MagicEYE-window is the hindmost window
  60.  
  61. --------------------------------------------------------------------------------
  62.  
  63. What do you need?
  64.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  65. need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
  66. version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
  67. In  addition to the OS you  should run your Workbench with at least 8 colors and
  68. a quadratic resolution (e.g.  640×512).  Last  but  not least you should  use an
  69. 13 point  high font  for screen title.  This is necassery,  because MagicEYE has
  70. an fixed high of  13 points.  And new for  release 2 of  MagicEYE  you  need the
  71. screennotify-library from  Stefan Becker (optional, if you want automatic  close
  72. of the MagicEYE-Window when WB close).
  73.  
  74. --------------------------------------------------------------------------------
  75.  
  76. Different program versions:
  77.   It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
  78. supported by MagicEYE. And so, I have produced two versions: One for AmigaOS 2.0
  79. (MagicEYE_37) and one for AmigaOS 3.0 (MagicEYE_39) and higher.
  80.  
  81. --------------------------------------------------------------------------------
  82.  
  83. How to install?
  84.   Nothing simpler than that: you copy only the right program-version of MagicEYE
  85. to your WBStartup-directory on you startvolume (disk, hd...). That's it :-]
  86.   When you  want  to  run  your  User-Startup,  than  copy  MagicEYE  into  your
  87. C-Directory and run MagicEYE from User-Startup.
  88.  
  89. --------------------------------------------------------------------------------
  90.  
  91. How to use?
  92.   You can run this program from the Workbench (or the WBStartup directory) and
  93. from a Shell (User-Startup).
  94.  
  95.   DONOTWAIT       : This has nothing  to do with  MagicEYE. It's only a flag for
  96.                     Workbench.
  97.   WIN_X           : Where  do you want to place  the MagicEYE-window?  Here  you
  98.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  99.                     WIN_Y=1
  100.                     ATTENTION: If  you use  an  titlefont smaller than 13 point,
  101.                     set the value of WIN_Y to 0.
  102.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  103.                     0, so, other programs (which need the system-time) gets more
  104.                     system-time. The default value is 0 (program) or -5 (Icon).
  105.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  106.                     drag the  screen  with the  MagicEYE-window.  So there is no
  107.                     different on  the screen-title,  when  you want to drag down
  108.                     the screen (funny). Default is off!
  109.   BACKGROUND      : Copy the background of the  position, where the Eyes appears
  110.                     into the MagicEYE window (and so into the background).
  111.   QUICKQUIT       : Enable faster quitting of MagicEYE (with right Mousebutton).
  112.   BACKDROP        : Enable the Layer  Patch,  that bring the  MagicEYE window to
  113.                     the  hindmost  window  (every time!).  ATTENTION: with  this
  114.                     patch there will be the function BehindeLayer (-54) from the
  115.                     layer.library changed!
  116.   SLEEP_PERIOD    : This flag define the  time that  the program  wait,  till it
  117.                     close  the Eyes,  when the  mouse  isn't moved! Default: 50.
  118.                     (Try different values!)
  119.   FRESHUP_PER_SEC : This value  define,  how  often the  Eyes  are rendern  in a
  120.                     second. So, you have here the posibility to define, how much
  121.                     system-time is used from MagicEYE  (and of course  with  the
  122.                     PRIORITY).  An example: If you give as FRESHUP_PER_SEC an 1,
  123.                     the Eyes is renderd  once in a second. Default  is 50 (=> so
  124.                     MagicEYE renders the Eyes 50 times a second). The max. value
  125.                     for this flag  is 100 (Or have  you an screen-mode with more
  126.                     then 100Hz?). 
  127.  
  128. And now the effect-configuration. Very  important to know: The values,  that you
  129. give here, are interpreted as a probability (1/value). The value must be greater
  130. than 1:
  131.  
  132.   SLEEPY          : This  value is  needed, to  define how  often the  Eyes  are
  133.                     closed. 
  134.   TIRED           : Define, how often the eye-lid's go down to the half.
  135.   ROLL_SYNCHRON   : When roll the Eye synchron (in same direction).
  136.   ROLL_ASYNCHRON  : When roll the Eye asynchron (in different direction).
  137.   LEFTRIGHT       : How often the Eye's look Left-Right.
  138.   RANDOM_EYE      : Defines, when you get the trembling Eye's.
  139.   BLOODY          : When get the red Eye's?
  140.  
  141.   So, that's it.  You know now all the features  of MagicEYE. Or...? You want to
  142. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  143. program?  Ok. I see... You want  know  this (very stupied :-|) feature: There
  144. are two ways:
  145. 1.) Run MagicEYE again!
  146. 2.) Run Exchange, select MagicEYE and quit it!
  147. 3.) (when QUICKQUIT) Aktivate MagicEYE-Window and press right Mousebutton!
  148.  
  149. --------------------------------------------------------------------------------
  150.  
  151. What can be made better?
  152.   * More funny things with the Eyes
  153.   * Eye's with eyebrow's?
  154.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  155.     which we doesn't want!
  156.  
  157. --------------------------------------------------------------------------------
  158.  
  159. For any reaseon (bug-report, ideas ...) try this:
  160.  
  161.                  sMail:           Christian Krapp
  162.                                   Hagenmähderstr. 9
  163.                                 D-86391 Stadtbergen
  164.                                   (GERMANY)
  165.                  eMail:           krabbe@informatik.fh-augsburg.de
  166.  
  167. --------------------------------------------------------------------------------
  168.  
  169. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  170.  
  171. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation).
  172. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  173. Vxx.2   01.08.1995 - Silly error removed (Thanks Roland Fulde).
  174.                    - Colorizing implemented  (Markus Speicher and Mario Cattaneo
  175.                      were interessted, only 39.x-Version).
  176.                    - ScreenNotify-Library supported (Mario Cattaneo).
  177.                    - Rolling Eye (Dirk Wrocklage).
  178.                    - Tremble and red Eye's (Michael Krapp).
  179.                    - Rolling  Eye  asynchron,  tired  Eye  and  look  Left-Right
  180.                      (Christian Krapp)
  181. Vxx.3   01.03.1996 - ScreenNotify-Library optional!
  182.                    - supports Commodity-Library 
  183.                    - red Eye's become white after a while of closed Eye's
  184.                    - removed  time-waste  when Eye's are  closed  (problems with
  185.                      Nemac IV)
  186. Vxx.4   20.02.1997 - Trancparent background (optional)!
  187.                    - Quickquit again included!
  188.                    - MagicEYE window is hindmost window
  189.                    - MagicEYE in WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  190.  
  191. --------------------------------------------------------------------------------
  192.